Data Groups
With few exceptions, data groups must be defined in a device template file (DTF) in order for them to be available for use on a remote device. Which data groups are defined by a device template file depends on protocol, device type, and unique configuration.
CygNet distributes sample device template files for its EIEs, each of which typically serves one or more hardware models along with applicable firmware. Therefore, the data groups described below are only those data groups defined by CygNet in sample device template file(s). Your template(s) might not include some of the data groups described below. Device template files exist to enable users to customize device configurations; however, CygNet is not responsible for changes made by users.
For information about data group definitions and device template files, see Device Template Files.
For more information about data group dependencies, see Data Group Dependencies.
Notes:
-
When point processing is performed on history data groups, only closed records will be published and processed to points. If a device has leading timestamped records and returns the current, open record, point processing will not be performed for that record, even though there is data in the DDS transaction. The point record will be updated only when that record is closed. This is to avoid a situation where a point has multiple entries with the same timestamp, since an open record may be still updating values with each new poll, but each update will have the same timestamp. For example, say you start polling for a daily history record at 8:00am, you’ll get the first value at 8:00am, then if you poll every five minutes, you’ll get new values throughout the day at the exact same timestamp. A history record is basically an array of data with a timestamp and values where the values have different process variables for each incremental poll. The timestamp won’t get written until the record is closed, which happens at the end of the time period, in this case, a day.
- Best practice recommends that you do not perform UDC and point processing on FMS data groups. The DEIDs specified in FMS data groups are generic and use the eFMS enumeration to identify the CygNet-defined FMS items referenced in the device template file. No polling is done on these data groups — all data is coming from the native data groups. Points should be mapped to the native data groups since that is the data group that is actually processing the device data. While point processing may work on the FMS data groups, it is not supported, not tested, not consistent across EIEs, and is not recommended practice.
ProSoft EIE Data Groups
Browse by letter: [A] [C] [G] [H] [M] [S]
| Data Group Type | Usage Notes |
|---|---|
|
"Gas Analysis Config" |
|
|
AgaCfg |
"Aga Configuration" |
|
CfgMB |
The "Configurable Data Group" data group provides a flexible way to create custom data groups on a per-device basis. See Configurable Data Group. |
|
The "Composite Data Group" is a special kind of data group that enables you to combine any data group element(s) from any data group(s) as long as they are in the same template as the composite data group. The "Composite Data Group" does not appear in a remote device editor unless it has been defined in the relevant device template file. See Composite Data Group. |
|
|
CHstGDRecD |
"Cur Gas Diff Hist (daily)" |
|
CHstGDRecH |
"Cur Gas Diff Hist (hrly)" |
|
CHstGPRecD |
"Cur Gas Pulse Hist (daily)" |
|
CHstGPRecH |
"Cur Gas Pulse Hist (hrly)" |
|
CHstLDRecD |
"Cur Liquid Diff Hist (daily)" |
|
CHstLDRecH |
"Cur Liquid Diff Hist (hrly)" |
|
CHstLPRecD |
"Cur Liquid Pulse Hist (daily)" |
|
CHstLPRecH |
"Cur Liquid Pulse Hist (hrly)" |
|
CtrlCfg |
A valid "Controller Configuration" data group must be retrieved before other data groups can be retrieved or sent. |
|
CtrlInfo |
"Controller Info" |
|
"FMS Legacy Config Send Data" This data group depends on supporting data groups to be defined in order for successful transactions to be completed. |
|
|
"FMS Legacy Configuration Data" must be retrieved before other FMS Legacy data groups of the same ordinal can be retrieved. This data group depends on supporting data groups to be defined in order for successful transactions to be completed. |
|
|
"FMS Legacy History Data" This data group depends on supporting data groups to be defined in order for successful transactions to be completed. |
|
|
"History - Daily" |
|
|
"History - Hourly" |
|
|
"Meter Config" |
|
|
"Single Read-Only Coil" Only one instance of this data group allowed. |
|
|
"Single Read/Write Coil" Only one instance of this data group allowed. |
|
|
"Single R/O Register" Only one instance of this data group allowed. |
|
|
"Single R/W Register" Only one instance of this data group allowed. |


